home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL / glpixelmap.z / glpixelmap
Encoding:
Text File  |  1998-10-20  |  18.6 KB  |  200 lines
  1.  
  2.  
  3.  
  4. ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv,,,, ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv,,,, ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv - set up pixel transfer maps
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv( GLenum _m_a_p,
  14.                         GLint _m_a_p_s_i_z_e,
  15.                         const GLfloat *_v_a_l_u_e_s )
  16.      void ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv( GLenum _m_a_p,
  17.                          GLint _m_a_p_s_i_z_e,
  18.                          const GLuint *_v_a_l_u_e_s )
  19.      void ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv( GLenum _m_a_p,
  20.                          GLint _m_a_p_s_i_z_e,
  21.                          const GLushort *_v_a_l_u_e_s )
  22.  
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _m_a_p      Specifies a symbolic map name.  Must be one of the following:
  26.               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR,
  27.               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA,
  28.               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB,
  29.               or GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA.
  30.  
  31.      _m_a_p_s_i_z_e  Specifies the size of the map being defined.
  32.  
  33.      _v_a_l_u_e_s   Specifies an array of _m_a_p_s_i_z_e values.
  34.  
  35. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  36.      ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp sets up translation tables, or _m_a_p_s, used by ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss,
  37.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  38.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  39.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, and ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD.  Use of these maps is
  40.      described completely in the ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr reference page, and partly in
  41.      the reference pages for the pixel and texture image commands. Only the
  42.      specification of the maps is described in this reference page.
  43.  
  44.      _m_a_p is a symbolic map name, indicating one of ten maps to set.  _m_a_p_s_i_z_e
  45.      specifies the number of entries in the map, and _v_a_l_u_e_s is a pointer to an
  46.      array of _m_a_p_s_i_z_e map values.
  47.  
  48.      The ten maps are as follows:
  49.  
  50.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII           Maps color indices to color indices.
  51.  
  52.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS           Maps stencil indices to stencil indices.
  53.  
  54.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR           Maps color indices to red components.
  55.  
  56.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG           Maps color indices to green components.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB           Maps color indices to blue components.
  75.  
  76.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA           Maps color indices to alpha components.
  77.  
  78.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR           Maps red components to red components.
  79.  
  80.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG           Maps green components to green components.
  81.  
  82.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB           Maps blue components to blue components.
  83.  
  84.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA           Maps alpha components to alpha components.
  85.  
  86.      The entries in a map can be specified as single-precision floating-point
  87.      numbers, unsigned short integers, or unsigned long integers.  Maps that
  88.      store color component values (all but GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII and
  89.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS) retain their values in floating-point format, with
  90.      unspecified mantissa and exponent sizes.  Floating-point values specified
  91.      by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv are converted directly to the internal floating-point
  92.      format of these maps, then clamped to the range [0,1].  Unsigned integer
  93.      values specified by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv and ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv are converted
  94.      linearly such that the largest representable integer maps to 1.0, and 0
  95.      maps to 0.0.
  96.  
  97.      Maps that store indices, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS,
  98.      retain their values in fixed-point format, with an unspecified number of
  99.      bits to the right of the binary point.  Floating-point values specified
  100.      by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppffffvvvv are converted directly to the internal fixed-point format
  101.      of these maps.  Unsigned integer values specified by ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuussssvvvv and
  102.      ggggllllPPPPiiiixxxxeeeellllMMMMaaaappppuuuuiiiivvvv specify integer values, with all 0's to the right of the
  103.      binary point.
  104.  
  105.      The following table shows the initial sizes and values for each of the
  106.      maps.  Maps that are indexed by either color or stencil indices must have
  107.                 n
  108.      _m_a_p_s_i_z_e = 2  for some n or the results are undefined.  The maximum
  109.      allowable size for each map depends on the implementation and can be
  110.      determined by calling ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE.  The
  111.      single maximum applies to all maps; it is at least 32.
  112.  
  113.            _m_a_p          _l_o_o_k_u_p _i_n_d_e_x   _l_o_o_k_u_p _v_a_l_u_e  _i_n_i_t_i_a_l _s_i_z_e _i_n_i_t_i_a_l _v_a_l_u_e
  114.    ____________________________________________________________________________
  115.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII  color index    color index        1             0
  116.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS stencil index  stencil index       1             0
  117.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR  color index         R             1             0
  118.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG  color index         G             1             0
  119.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB  color index         B             1             0
  120.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA  color index         A             1             0
  121.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR       R              R             1             0
  122.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG       G              G             1             0
  123.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB       B              B             1             0
  124.    GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA       A              A             1             0
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp((((3333GGGG))))
  138.  
  139.  
  140.  
  141. EEEERRRRRRRROOOORRRRSSSS
  142.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_a_p is not an accepted value.
  143.  
  144.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _m_a_p_s_i_z_e is less than one or larger than
  145.      GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE.
  146.  
  147.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _m_a_p is GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII,
  148.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG,
  149.      GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB, or GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA, and _m_a_p_s_i_z_e is not a power
  150.      of two.
  151.  
  152.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp is executed between the
  153.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  154.  
  155. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  156.      ggggllllGGGGeeeettttPPPPiiiixxxxeeeellllMMMMaaaapppp
  157.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____IIII____SSSSIIIIZZZZEEEE
  158.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____SSSS____TTTTOOOO____SSSS____SSSSIIIIZZZZEEEE
  159.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR____SSSSIIIIZZZZEEEE
  160.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG____SSSSIIIIZZZZEEEE
  161.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB____SSSSIIIIZZZZEEEE
  162.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA____SSSSIIIIZZZZEEEE
  163.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____RRRR____TTTTOOOO____RRRR____SSSSIIIIZZZZEEEE
  164.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____GGGG____TTTTOOOO____GGGG____SSSSIIIIZZZZEEEE
  165.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____BBBB____TTTTOOOO____BBBB____SSSSIIIIZZZZEEEE
  166.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____AAAA____TTTTOOOO____AAAA____SSSSIIIIZZZZEEEE
  167.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____TTTTAAAABBBBLLLLEEEE
  168.  
  169. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  170.      ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  171.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr,
  172.      ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  173.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.